Add2it Go-To Free - readme.txt: - Demo Mode: On
########################################
# Add2it Go-To Free V1.21     10/13/03 #
# Download at:   http://www.add2it.com #
########################################
# Copyright 2001-2003 by Frank Bauer   #
# Add2it.com - All Rights Reserved.    #
########################################


Contents:
#########

1. Description & Features
2. Add2it Affiliate Program
3. Script Info
4. Copyright Notice
5. Disclaimer
6. Installation Instructions
7. Script History
8. Manual
9. Support Forum
10. Add2it Scripts Update + Announcement List


1. Description & Features :
###########################

You can find the most current description and list of features at:
http://www.add2it.com/scripts/go-to-free.shtml

2. Add2it Affiliate Program :
#############################

You can find all details about the Add2it.com Affiliate Program and how you can earn up to 50% commissions at:
http://www.add2it.com/ref/
The Add2it.com Affiliate Program Sign-Up Form is located at:
http://www.add2it.com/ref/affiliates.cgi?signup_form=1
Affiliates can log-in at:
http://www.add2it.com/ref/affiliates.cgi

3. Script Info :
################

Version:       1.21
Released:      10/13/03
Platform:      Unix & Windows server
Requirements:  Perl 5.0 or higher
               You must have FULL cgi-bin access
               You need to be able to set permissions (only Unix)
               Perl modules:  CGI::Carp, Fcntl, Socket, Time::Local, IO::Socket (A good host will have them all)
Take a look at the online demo at:
http://www.add2it.com/gtf/demo/admin.cgi
Password:  add2it

4. Copyright Notice :
#####################

This scripts is for your use only and you may NOT distribute them to other parties.  
You can install this script per license ONE TIME on ONE server and it is not allowed to make modifications in any way, shape or form to the scripts.
Add2it.com has spent 100's of man hours to create a free software to help you - please respect OUR RIGHTS in giving you this software FREE for your unlimited usage, by NOT violating our rights as the sole copyright owners and creators of this scripts.
You may not in any way, shape or form adjust, reprogram or change this scripts.
All coding is copyright Frank Bauer, Add2it.com and is licensed to you for your usage only.  This scripts and all it's components are whole created, owned, and copyrighted Add2it.com.
In other words you are only allowed to install and use this scripts ONLY - you may NOT change it, or use any part of it in whole or in part in any other program or any other way, shape or form without permission of Add2it.com.
By installing and/or using this scripts you agree to these terms and shall be binding in a court of law - in all countries worldwide - forever.  All people that violate these terms will be dealt with by legal means - any person that informs Add2it.com of a copyright violation, will be rewarded.
Please visit Add2it.com if you require special services at:
http://www.add2it.com

5. Disclaimer :
###############

This software is provided as is - Add2it.com will not be held responsible for any loss or damage indirectly or directly caused by your installing and using this scripts in any way, shape or form.  By installing this scripts you agree, completely and absolutely with all terms in this README.TXT file and release Add2it.com from any and all responsibility by you using this scripts.

6. Installation Instructions :
##############################

1. To unpack the GTF121.ZIP file, go to the folder where you saved it to and unzip the file into a directory of your choice.

2. If you do not have ZIP decompression software installed on your computer, get it for free at:
http://www.shareware.com
3. The installation of this script is simple, no variables or setting need to be adjusted prior to upload.  All settings are accessible online, via the Admin Control Center.

4. The path to Perl within the scripts is set to the typical standard value of /usr/bin/perl.  This path works on 90% of the servers.

If you know that the path to Perl is different on your server, please consult the "Troubleshooting" section below to see in which files the path to Perl has to be changed.
5. This program must be uploaded to your server where your website files are located.

This program is tested on UNIX and WINDOWS server systems.
6. To upload, you will need an FTP program.  Either WS-FTP or CUTE-FTP, free at:
http://www.shareware.com
For Macs, you will need a copy of FETCH.
Upload using FRONTPAGE is NOT recommended AND will NOT WORK.
7. Start up your FTP program.  For this example, WS-FTP software program is used.  Other programs will be similar.

All you are doing is moving all files from your local computer to the server where your website files are located, and setting the permissions of install.cgi to allow the script to be treated like a program.
8. Login into your website account using your FTP username and FTP password.

9. Create a new a new directory for the scripts in your CGI / CGI-BIN folder or somewhere else*.  The recommended name for this new directory is "go".  Set the file upload to ASCII only [ASCII mode].

CGI-BIN permissions are set by the server and no attempt should be made to change them.
On some servers you will have to CREATE a CGI-BIN - to do this:
MKDIR cgi-bin
And set the permissions on UNIX systems to 755.
[CHMOD 755 - see below for example.]
* NOTE: If you attempt to install this in a directory other than a CGI/CGI-BIN, even with the proper permissions set on both the FILE and DIRECTORY the files are located in it MAY  NOT WORK as some web servers restrict where CGI programs can operate and run.
10. On UNIX systems set permissions on this new folder.

Once created, CHMOD [right click - this will be under settings in other programs, other than WS-FTP] this directory to 755**.
Visually, Setting are as follows [WS-FTP]:
        Owner    USER     Other
READ    [YES]    [YES]    [YES]
WRITE   [YES]    [NO]     [NO]
EXECUTE [YES]    [YES]    [YES]
Some servers MAY require CHMOD 777 or visually, setting are as follows [WS-FTP]:
        Owner    USER     Other
READ    [YES]    [YES]    [YES]
WRITE   [YES]    [YES]    [YES]
EXECUTE [YES]    [YES]    [YES]
** "CHMOD" means change permissions to allow this program to be treated as a program [vs a webpage] and allow it to do certain things.  This is only necessary on UNIX systems.
On some servers, you may have to use a program called TELNET to go and change the settings...
[CHMOD] - consult with your server company for instructions on this - generally speaking most hosting companies have this info in an online instructions manual.
You can also view the online manuals at:
http://www.best-host.com/
For instructions on TELNET, general uploading of files and setting permissions.
11. Open this folder.

12. Select the folder/directory in your computer where you unzipped the GTF121.ZIP file.

13. Upload the following files in ASCII mode to the new folder on your server:

- .htaccess (upload ONLY if .pl files can't be executed)
- admin.cgi
- admin.pl
- get.pl
- gtf-sublib.pl
- index.htm
- index.pl
- install.cgi
- install.pl
- liesmich.txt
- readme.txt
- stats.pl
- to.cgi
- to.pl
- data-index.htm
- data-language.dat
- data-lang-index.htm
- data-lang-dutch-language.kit
- data-lang-dutch-language2.kit
- data-lang-dutch-language3.kit
- data-lang-eng-language.kit
- data-lang-eng-language2.kit
- data-lang-eng-language3.kit
- data-lang-ger-language.kit
- data-lang-ger-language2.kit
- data-lang-ger-language3.kit
- variables.pl
14. On UNIX systems, set the permissions of the install.pl file.  CHMOD mode it [right click over the install.pl script] and also set it to 755 as above.

15. You are now ready to let the install.pl file do the rest of the installation process.

Open your browser and call install.pl to install the rest of the script.  Depending on where the new directory is located the path could be e.g.:
http://www.yourserver.com/cgi-bin/go/install.pl or
http://www.yourserver.com/go/install.pl
All sub-directories will be created automatically, all files will be moved into the proper sub-directories and on Unix systems all file and directory permissions will be adjusted automatically.
If there is any problem, the script will let you know what it is.
16. Then call install.pl to setup the script.  All necessary variables will be set.  Please enter the URL to the directory where the scripts are located, choose if you want all outgoing emails to be send with Sendmail (Unix) or with your SMTP server (Unix or Windows), enter the administrators email address and password.  Modify all other settings as you like.

17. Now you need to enter your order number as well as your order password for this script.  Please enter them to finish the registration.

18. Click on "Links & Stats" and enter the link name and URL to add your first link.

...All done!

Note:  You can update from the free to the pro version as well as from any earlier version to the most current version at any time without losing any of your settings, links or statistics.  Just upload the pro version files as mentioned in that versions readme.txt file and leave all other files on your server as they are.

Troubleshooting :
=================

1. First, if you get an error - make sure you uploaded all files in ASCII format only.  Uploading in BINARY will corrupt the files.

2. If you attempt to run the script, and get a server error double check you set the permissions as shown above on both the DIRECTORY the script is uploaded to AND the FILE install.pl - if you still get an error try CHMODing the DIRECTORY ONLY to 777 [visually, all permissions are "YES"], then re-try the script initialization.

If necessary, adjust the path to Perl within these files:
- admin.cgi
- admin.pl
- index.pl
- install.cgi
- install.pl
- to.cgi
- to.pl
At the top of each script (and it must remain as the first line) is a default path to the Perl program on your host server.  This can vary slightly between UNIX servers.  If you have problems running the scripts, check with your host support staff about the correct path described in this line.  The default entry is "#!/usr/bin/perl" and another common variation is "#!/usr/local/bin/perl".  In Perl scripts the hash sign "#" character comments out the code on a line starting with this character.  Here it has a special meaning to Perl.
NOTE: If you attempt to install this in a directory other than a CGI/CGI-BIN, even with the proper permissions set on both the FILE and DIRECTORY the files are located in it MAY NOT WORK as some web servers restrict where CGI programs can operate and run.
3. Upon initialization "I can't create this file" - This means the permissions are wrong on the DIRECTORY only - the one you created to upload the files to. Check as noted above in number 2.

4. I try to send myself a statistics report and get a server error.

This means the SENDMAIL or SMTP server settings are incorrect for your script.  Click on "Change the settings of Add2it Go-To Free", and check the SENDMAIL or SMTP server settings.  Consult with your web hosting company for the CORRECT SENDMAIL or SMTP server settings for your server.
5. For all other troubling shooting and questions visit:
http://www.add2it.com/cgi-bin/discus/show.cgi?13/13
6. If you would like to have this script installed on your website, please order the Installation Service at:
http://www.add2it.com/scripts/order.shtml

7. Script History :
###################

You can find the Script History online at:
http://www.add2it.com/scripts/go-to-free-history.shtml

8. Manual of Add2it Go-To Free :
################################

1. The administrator needs the index.pl script to:

- Links & Stats
  - View stats
  - Add new links
    - Choose a link name with up to 20 characters
      (e.g. more4u)
      Note: Each link name has to be unique and all spaces will be converted to dashes.
    - Enter an URL with up to 400 characters
      (e.g. http://www.add2it.com/news/)
      Note: Each URL has to start with http:// or https://.
    - Choose if you want to use InstaHe!p live support and / or tracking
      Note:  This requires InstaHe!p.  A 15 days free trial is available at:  http://instahelp.add2it.com
    - Click first on 'ADD New Link' and then on 'Make Changes'
  - Edit links
    - Choose a link that you want to edit by pressing on the 'ED' link next to link you want to edit or enter a link name by hand
    - Change the URL and use up to 400 characters
      (e.g. http://www.add2it.com/news/)
      Note: Each URL has to start with http:// or https://.
    - Choose if you want to use InstaHe!p live support and / or tracking
      Note:  This requires InstaHe!p.  A 15 days free trial is available at:  http://instahelp.add2it.com
    - Click first on 'EDIT This Link' and then on 'Make Changes'
  - Reset link counters
    - Choose a link that you want to edit by pressing on the 'ED' link next to link you want to edit or enter a link name by hand
    - Click first on 'RESET Count' and then on 'Make Changes'
  - Delete links
    - Choose a link that you want to edit by pressing on the 'ED' link next to link you want to edit or enter a link name by hand
    - Click first on 'DELETE This Link' and then on 'Make Changes'
- Receive a link statistic report via email
  - Click on the button to get an uptodate link statistic report send to your email address
- Change the settings of Add2it Go-To Free
  - Choose your preferred language
  - URL of directory in which the script files are located
  - Path to sendmail (Unix) or
  - SMTP server and port address (Unix and Windows)
    Note: Enter only one of the above, either the path to sendmail OR the SMTP server and port address.
  - At "New Message Line" type you should choose "RFC 822 compatible" only if you get an error message like "Message not accepted for delivery: 451 See http://pobox.com/~djb/docs/smtplf.html" or "Bare LF detected" when the script tries to send an email.
  - Email address of administrator
  - If you are a member of the Add2it Affiliate Program, enter your ID here to show all links with your id.
    Note:  Here you can join the Add2it Affiliate Program:  http://www.add2it.com/ref/
  - To offer live support and track visitors on any web site that you are promoting (even if it's not yours), InstaHe!p provides you with a new, professional way to approach potential customers that otherwise never existed until now! Here you can enter your InstaHe!p SiteID.
    Note:  This requires InstaHe!p.  A 15 days free trial is available at:  http://instahelp.add2it.com
  - If you are a member of the InstaHe!p affiliate program, enter your ID here to show all links with your id.
  - Change password of admin center
Please call index.pl with:
http://www.yourdomain.com/cgi-bin/go/index.pl
    (preferred language)
e.g. http://www.ads.com/cgi-bin/go/index.pl
http://www.yourdomain.com/cgi-bin/go/index.pl?language=<language-sub-dir>
    (any other language)
e.g. http://www.ads.com/cgi-bin/go/index.pl?language=ger

2. The administrator needs the to.pl script to:

- automatically fowarded ad viewers to the requested URL and to test a link without counting
Ad viewers call to.pl with this links:
http://www.yourdomain.com/cgi-bin/go/to.pl?l=<link name>
        (preferred language)
e.g. http://www.ads.com/cgi-bin/go/to.pl?l=more4u
http://www.yourdomain.com/cgi-bin/go/to.pl?l=<link name>&language=<language-sub-dir>
    (any other language)
e.g. http://www.ads.com/cgi-bin/go/to.pl?l=more4u&language=ger
Administrators can call to.pl with this links (to test without counting):
http://www.yourdomain.com/cgi-bin/go/to.pl?t=<link name>
    (preferred language)
e.g. http://www.ads.com/cgi-bin/go/to.pl?t=more4u
http://www.yourdomain.com/cgi-bin/go/to.pl?t=<link name>&language=<language-sub-dir>
    (any other language)
e.g. http://www.ads.com/cgi-bin/go/to.pl?t=more4u&language=ger

9. Support Forum :
##################

You can find the Add2it Go-To Free Support Forum at:
http://www.add2it.com/cgi-bin/discus/show.cgi?13/13

10. Add2it Scripts Update + Announcement List :
###############################################

You can subscribe to the Add2it Scripts Update + Announcement List at:
http://www.add2it.com/mmp/sub.pl?scripts=!FLM

########################################
# Add2it Go-To Free V1.21     10/13/03 #
# Download at:   http://www.add2it.com #
########################################
# Copyright 2001-2003 by Frank Bauer   #
# Add2it.com - All Rights Reserved.    #
########################################

Add2it Go-To Free 1.21
[ Read Manual | Affiliate Program | Sign-Up | Login ]
© 2000-2024 by Frank Bauer
add2it.com


Click here to go back!